home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / XmPrimitive.z / XmPrimitive
Encoding:
Text File  |  1998-10-20  |  32.6 KB  |  529 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee - The Primitive widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           Primitive is a widget class used as a supporting superclass
  20.           for other widget classes.  It handles border drawing and
  21.           highlighting, traversal activation and deactivation, and
  22.           various callback lists needed by Primitive widgets.
  23.  
  24.         CCCCllllaaaasssssssseeeessss
  25.           Primitive inherits behavior and resources from CCCCoooorrrreeee class.
  26.  
  27.           The class pointer is xxxxmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeeeWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  28.  
  29.           The class name is XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee.
  30.  
  31.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  32.           The following table defines a set of widget resources used
  33.           by the programmer to specify data.  The programmer can also
  34.           set the resource values for the inherited classes to set
  35.           attributes for this widget.  To reference a resource by name
  36.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  37.           prefix and use the remaining letters.  To specify one of the
  38.           defined values for a resource in a .Xdefaults file, remove
  39.           the XXXXmmmm prefix and use the remaining letters (in either
  40.           lowercase or uppercase, but include any underscores between
  41.           words).  The codes in the access column indicate if the
  42.           given resource can be set at creation time (C), set by using
  43.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  44.           not applicable (N/A).
  45.  
  46.                                          XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  47.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  48.      ________________________________________________________________________________________________
  49.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel              dynamic                CSG
  50.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap             XmUNSPECIFIED_PIXMAP   CSG
  51.      XmNforeground           XmCForeground           Pixel              dynamic                CSG
  52.      XmNhelpCallback         XmCCallback             XtCallbackList     NULL                   C
  53.      XmNhighlightColor       XmCHighlightColor       Pixel              dynamic                CSG
  54.      XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean            False                  CSG
  55.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap             dynamic                CSG
  56.      XmNhighlightThickness   XmCHighlightThickness   Dimension          2                      CSG
  57.      XmNnavigationType       XmCNavigationType       XmNavigationType   XmNONE                 CSG
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      XmNshadowThickness      XmCShadowThickness      Dimension          2                      CSG
  75.      XmNtopShadowColor       XmCTopShadowColor       Pixel              dynamic                CSG
  76.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap             dynamic                CSG
  77.      XmNtraversalOn          XmCTraversalOn          Boolean            True                   CSG
  78.      XmNunitType             XmCUnitType             unsigned char      dynamic                CSG
  79.      XmNuserData             XmCUserData             XtPointer          NULL                   CSG
  80.  
  81.           XXXXmmmmNNNNbbbboooottttttttoooommmmSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr
  82.                     Specifies the color to use to draw the bottom and
  83.                     right sides of the border shadow.  This color is
  84.                     used if the XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp resource is
  85.                     unspecified.
  86.  
  87.           XXXXmmmmNNNNbbbboooottttttttoooommmmSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp
  88.                     Specifies the pixmap to use to draw the bottom and
  89.                     right sides of the border shadow.
  90.  
  91.           XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd
  92.                     Specifies the foreground drawing color used by
  93.                     Primitive widgets.
  94.  
  95.           XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk
  96.                     Specifies the list of callbacks that is called
  97.                     when the help key is pressed.  The reason sent by
  98.                     the callback is XXXXmmmmCCCCRRRR____HHHHEEEELLLLPPPP.
  99.  
  100.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttCCCCoooolllloooorrrr
  101.                     Specifies the color of the highlighting rectangle.
  102.                     This color is used if the highlight pixmap
  103.                     resource is XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPIIIIXXXXMMMMAAAAPPPP.
  104.  
  105.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttOOOOnnnnEEEEnnnntttteeeerrrr
  106.                     Specifies if the highlighting rectangle is drawn
  107.                     when the cursor moves into the widget.  If the
  108.                     shell's focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, this resource
  109.                     is ignored, and the widget is highlighted when it
  110.                     has the focus.  If the shell's focus policy is
  111.                     XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR and if this resource is True, the
  112.                     highlighting rectangle is drawn when the the
  113.                     cursor moves into the widget.  If the shell's
  114.                     focus policy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR and if this resource is
  115.                     False, the highlighting rectangle is not drawn
  116.                     when the the cursor moves into the widget.  The
  117.                     default is False.
  118.  
  119.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttPPPPiiiixxxxmmmmaaaapppp
  120.                     Specifies the pixmap used to draw the highlighting
  121.                     rectangle.
  122.  
  123.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttTTTThhhhiiiicccckkkknnnneeeessssssss
  124.                     Specifies the thickness of the highlighting
  125.                     rectangle.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee
  141.                     Determines whether the widget is a tab group.
  142.  
  143.  
  144.                       +o  XXXXmmmmNNNNOOOONNNNEEEE indicates that the widget is not a tab
  145.                          group.
  146.  
  147.                       +o  XXXXmmmmTTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP indicates that the widget is a
  148.                          tab group, unless another widget in the
  149.                          hierarchy has an XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee of
  150.                          XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP.
  151.  
  152.                       +o  XXXXmmmmSSSSTTTTIIIICCCCKKKKYYYY____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP indicates that the widget
  153.                          is a tab group, even if another widget in the
  154.                          hierarchy has an XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee of
  155.                          XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP.
  156.  
  157.                       +o  XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP indicates that the
  158.                          widget is a tab group and that widgets in the
  159.                          hierarchy whose XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is
  160.                          XXXXmmmmTTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP are not tab groups.
  161.  
  162.                          When a parent widget has an XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee
  163.                          of XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP, traversal of non-
  164.                          tab-group widgets within the group is based
  165.                          on the order of those widgets in their
  166.                          parent's XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn list.
  167.  
  168.                          When any widget in a hierarchy has an
  169.                          XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee of XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP,
  170.                          traversal of tab groups in the hierarchy
  171.                          proceeds to widgets in the order in which
  172.                          their XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee resources were
  173.                          specified as XXXXmmmmEEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP or
  174.                          XXXXmmmmSSSSTTTTIIIICCCCKKKKYYYY____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP, whether by creating the
  175.                          widgets with that value, by calling
  176.                          XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss, or by calling XXXXmmmmAAAAddddddddTTTTaaaabbbbGGGGrrrroooouuuupppp.
  177.  
  178.  
  179.           XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss
  180.                     Specifies the size of the drawn border shadow.
  181.  
  182.           XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwCCCCoooolllloooorrrr
  183.                     Specifies the color to use to draw the top and
  184.                     left sides of the border shadow.  This color is
  185.                     used if the XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp resource is
  186.                     unspecified.
  187.  
  188.           XXXXmmmmNNNNttttooooppppSSSShhhhaaaaddddoooowwwwPPPPiiiixxxxmmmmaaaapppp
  189.                     Specifies the pixmap to use to draw the top and
  190.                     left sides of the border shadow.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))
  203.  
  204.  
  205.  
  206.           XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn
  207.                     Specifies if traversal is activated for this
  208.                     widget.  In CascadeButton and CascadeButtonGadget,
  209.                     this resource is forced to TRUE unless the parent
  210.                     is an OptionMenu.
  211.  
  212.           XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee
  213.                     Provides the basic support for resolution
  214.                     independence.  It defines the type of units a
  215.                     widget uses with sizing and positioning resources.
  216.                     If the widget's parent is a subclass of XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr
  217.                     and if the XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee resource is not explicitly
  218.                     set, it defaults to the unit type of the parent
  219.                     widget.  If the widget's parent is not a subclass
  220.                     of XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, the resource has a default unit type
  221.                     of XXXXmmmmPPPPIIIIXXXXEEEELLLLSSSS.
  222.  
  223.                     XXXXmmmmNNNNuuuunnnniiiittttTTTTyyyyppppeeee can have the following values:
  224.  
  225.  
  226.                       +o  XXXXmmmmPPPPIIIIXXXXEEEELLLLSSSS-all values provided to the widget
  227.                          are treated as normal pixel values.
  228.  
  229.                       +o  XXXXmmmm111100000000TTTTHHHH____MMMMIIIILLLLLLLLIIIIMMMMEEEETTTTEEEERRRRSSSS-all values provided to
  230.                          the widget are treated as 1/100 millimeter.
  231.  
  232.                       +o  XXXXmmmm1111000000000000TTTTHHHH____IIIINNNNCCCCHHHHEEEESSSS-all values provided to the
  233.                          widget are treated as 1/1000 inch.
  234.  
  235.                       +o  XXXXmmmm111100000000TTTTHHHH____PPPPOOOOIIIINNNNTTTTSSSS-all values provided to the
  236.                          widget are treated as 1/100 point.  A point
  237.                          is a unit used in text processing
  238.                          applications and is defined as 1/72 inch.
  239.  
  240.                       +o  XXXXmmmm111100000000TTTTHHHH____FFFFOOOONNNNTTTT____UUUUNNNNIIIITTTTSSSS-all values provided to the
  241.                          widget are treated as 1/100 of a font unit.
  242.                          A font unit has horizontal and vertical
  243.                          components.  These are the values of the
  244.                          XmScreen resources XXXXmmmmNNNNhhhhoooorrrriiiizzzzoooonnnnttttaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt and
  245.                          XXXXmmmmNNNNvvvveeeerrrrttttiiiiccccaaaallllFFFFoooonnnnttttUUUUnnnniiiitttt.
  246.  
  247.  
  248.           XXXXmmmmNNNNuuuusssseeeerrrrDDDDaaaattttaaaa
  249.                     Allows the application to attach any necessary
  250.                     specific data to the widget.  It is an internally
  251.                     unused resource.
  252.  
  253.  
  254.         DDDDyyyynnnnaaaammmmiiiicccc CCCCoooolllloooorrrr DDDDeeeeffffaaaauuuullllttttssss
  255.           The foreground, background, top shadow, bottom shadow, and
  256.           highlight color resources are dynamically defaulted.  If no
  257.           color data is specified, the colors are automatically
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))
  269.  
  270.  
  271.  
  272.           generated.  On a single-plane system, a black and white
  273.           color scheme is generated.  Otherwise, four colors are
  274.           generated, which display the correct shading for the 3-D
  275.           visuals.  If the background is the only color specified for
  276.           a widget, the top shadow and bottom shadow colors are
  277.           generated to give the 3-D appearance.  Foreground and
  278.           highlight colors are generated to provide sufficient
  279.           contrast with the background color.
  280.  
  281.           Colors are generated only at creation.  Resetting the
  282.           background through XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss does not regenerate the other
  283.           colors.  XXXXmmmmCCCChhhhaaaannnnggggeeeeCCCCoooolllloooorrrr can be used to recalculate all
  284.           associated colors based on a new background color.
  285.  
  286.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  287.           Primitive inherits behavior and resources from the following
  288.           superclass.  For a complete description of each resource,
  289.           refer to the man page for that superclass.
  290.  
  291.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  292.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  293.      ______________________________________________________________________________________________________________
  294.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  295.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  296.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  297.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  298.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  299.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  300.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  301.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  302.      XmNdepth                        XmCDepth                        int              dynamic                CG
  303.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  304.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  305.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  306.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  307.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  308.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  309.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  310.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  311.      XmNx                            XmCPosition                     Position         0                      CSG
  312.      XmNy                            XmCPosition                     Position         0                      CSG
  313.  
  314.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  315.           A pointer to the following structure is passed to each
  316.           callback:
  317.  
  318.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  319.           {{{{
  320.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  321.             XXXXEEEEvvvveeeennnntttt       * _e_v_e_n_t;;;;
  322.           }}}} XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))
  335.  
  336.  
  337.  
  338.           _r_e_a_s_o_n Indicates why the callback was invoked.  For this
  339.                  callback, _r_e_a_s_o_n is set to XXXXmmmmCCCCRRRR____HHHHEEEELLLLPPPP.
  340.  
  341.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.
  342.  
  343.  
  344.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  345.           The XmPrimitive translations are listed below.  These
  346.           translations may not directly correspond to a translation
  347.           table.
  348.  
  349.           Note that for buttons in menus, altering translations in
  350.           ####oooovvvveeeerrrrrrrriiiiddddeeee or ####aaaauuuuggggmmmmeeeennnntttt mode is undefined.
  351.  
  352.           KKKKUUUUpppp::::           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeUUUUpppp(((())))
  353.           KKKKDDDDoooowwwwnnnn::::         PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeDDDDoooowwwwnnnn(((())))
  354.           KKKKLLLLeeeefffftttt::::         PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeLLLLeeeefffftttt(((())))
  355.           KKKKRRRRiiiigggghhhhtttt::::        PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeRRRRiiiigggghhhhtttt(((())))
  356.  
  357.           KKKKBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee::::    PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeHHHHoooommmmeeee(((())))
  358.  
  359.           KKKKNNNNeeeexxxxttttFFFFiiiieeeelllldddd::::    PPPPrrrriiiimmmmiiiittttiiiivvvveeeeNNNNeeeexxxxttttTTTTaaaabbbbGGGGrrrroooouuuupppp(((())))
  360.           KKKKPPPPrrrreeeevvvvFFFFiiiieeeelllldddd::::    PPPPrrrriiiimmmmiiiittttiiiivvvveeeePPPPrrrreeeevvvvTTTTaaaabbbbGGGGrrrroooouuuupppp(((())))
  361.  
  362.           KKKKAAAAccccttttiiiivvvvaaaatttteeee::::     PPPPrrrriiiimmmmiiiittttiiiivvvveeeePPPPaaaarrrreeeennnnttttAAAAccccttttiiiivvvvaaaatttteeee(((())))
  363.           KKKKCCCCaaaannnncccceeeellll::::       PPPPrrrriiiimmmmiiiittttiiiivvvveeeePPPPaaaarrrreeeennnnttttCCCCaaaannnncccceeeellll(((())))
  364.  
  365.           KKKKHHHHeeeellllpppp::::         PPPPrrrriiiimmmmiiiittttiiiivvvveeeeHHHHeeeellllpppp(((())))
  366.  
  367.  
  368.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  369.           The XmPrimitive action routines are described below:
  370.  
  371.  
  372.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeHHHHeeeellllpppp(((()))):
  373.                     Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
  374.                     exist.  If there are no help callbacks for this
  375.                     widget, this action calls the help callbacks for
  376.                     the nearest ancestor that has them.
  377.  
  378.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeNNNNeeeexxxxttttTTTTaaaabbbbGGGGrrrroooouuuupppp(((()))):
  379.                     Traverses to the first item in the next tab group.
  380.                     If the current tab group is the last entry in the
  381.                     tab group list, it wraps to the beginning of the
  382.                     tab group list.
  383.  
  384.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeePPPPaaaarrrreeeennnnttttAAAAccccttttiiiivvvvaaaatttteeee(((()))):
  385.                     If the parent is a manager, passes the KKKKAAAAccccttttiiiivvvvaaaatttteeee
  386.                     event received by the widget to the parent.
  387.  
  388.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeePPPPaaaarrrreeeennnnttttCCCCaaaannnncccceeeellll(((()))):
  389.                     If the parent is a manager, Passes the KKKKCCCCaaaannnncccceeeellll
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))
  401.  
  402.  
  403.  
  404.                     event received by the widget to the parent.
  405.  
  406.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeePPPPrrrreeeevvvvTTTTaaaabbbbGGGGrrrroooouuuupppp(((()))):
  407.                     Traverses to the first item in the previous tab
  408.                     group.  If the beginning of the tab group list is
  409.                     reached, it wraps to the end of the tab group
  410.                     list.
  411.  
  412.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeDDDDoooowwwwnnnn(((()))):
  413.                     Traverses to the next item below the current
  414.                     widget in the current tab group, wrapping if
  415.                     necessary.
  416.  
  417.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeHHHHoooommmmeeee(((()))):
  418.                     Traverses to the first widget or gadget in the
  419.                     current tab group.
  420.  
  421.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeLLLLeeeefffftttt(((()))):
  422.                     Traverses to the next item to the left of the
  423.                     current widget in the current tab group, wrapping
  424.                     if necessary.
  425.  
  426.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeNNNNeeeexxxxtttt(((()))):
  427.                     Traverses to the next item in the current tab
  428.                     group, wrapping if necessary.
  429.  
  430.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeePPPPrrrreeeevvvv(((()))):
  431.                     Traverses to the previous item in the current tab
  432.                     group, wrapping if necessary.
  433.  
  434.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeRRRRiiiigggghhhhtttt(((()))):
  435.                     Traverses to the next item to the right of the
  436.                     current gadget in the current tab group, wrapping
  437.                     if necessary.
  438.  
  439.           PPPPrrrriiiimmmmiiiittttiiiivvvveeeeTTTTrrrraaaavvvveeeerrrrsssseeeeUUUUpppp(((()))):
  440.                     Traverses to the next item above the current
  441.                     gadget in the current tab group, wrapping if
  442.                     necessary.
  443.  
  444.  
  445.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  446.           This widget has the additional behavior described below:
  447.  
  448.  
  449.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  450.                     If the shell's keyboard focus policy is
  451.                     XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, highlights the widget and gives it the
  452.                     focus.
  453.  
  454.           <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
  455.                     If the shell's keyboard focus policy is
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX))))
  467.  
  468.  
  469.  
  470.                     XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, unhighlights the widget and removes
  471.                     the focus.
  472.  
  473.  
  474.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  475.           The bindings for virtual keys are vendor specific.  For
  476.           information about bindings for virtual buttons and keys, see
  477.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  478.  
  479.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  480.           CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmCCCChhhhaaaannnnggggeeeeCCCCoooolllloooorrrr((((3333XXXX)))), and XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))).
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.